Language Testing Question Generator

Text2Quiz AI

Generate comprehension questions for language tests based on your text.

API Settings

Select your preferred AI provider and enter your API key. Note: Your API key is stored in your browser's local storage for convenience. Do not use this on shared computers.

API Provider

API Key

Step 1: Add Text

Step 2: Create Question

Text to Use

Base Information On

Question Format

Question Difficulty

Question Type

Question Type Details:

Select a question type to see details.

Vui lòng đọc kỹ hướng dẫn sử dụng bên dưới trước khi sử dụng.

Mọi đóng góp xin gửi về cho tác giả Lê Nguyễn Như Anh (email: anhlnn@hcmue.edu.vn)

Disclaimer:

Câu hỏi được tạo bởi AI có thể không hoàn toàn chính xác hoặc phù hợp với mọi ngữ cảnh giảng dạy – vui lòng rà soát kỹ trước khi sử dụng.

HƯỚNG DẪN SỬ DỤNG

🔐 1. Cách lấy API Key để sử dụng ứng dụng

Để ứng dụng hoạt động, bạn cần nhập API key.

Đừng lo! Ứng dụng không thu thập API key của bạn – key được lưu tạm trong trình duyệt (localStorage) để thuận tiện cho bạn thôi.

Bạn có thể chọn một trong hai loại API key sau:

🌟 Cách lấy Google Gemini API Key (Miễn phí)

👉 Xem video hướng dẫn cực nhanh (1 phút):
📺 https://youtu.be/kaKfUEgipEI

✅ Phù hợp với người mới, không cần thêm thẻ thanh toán.
✅ Sử dụng thoải mái với giới hạn miễn phí từ Google.

🤖 Cách lấy OpenAI API Key (Có tính phí)

👉 Xem hướng dẫn chính thức tại:
📄 https://help.openai.com/en/articles/4936850-where-do-i-find-my-openai-api-key

⚠️ Yêu cầu bạn có tài khoản OpenAI có liên kết thẻ thanh toán.
⚠️ Tính phí theo số lượng sử dụng (token).

📌 Lưu ý khi sử dụng API Key:

TUYỆT ĐỐI KHÔNG chia sẻ key công khai – tránh bị người khác dùng mất quota.
Key được lưu tạm thời trong trình duyệt của bạn (không gửi đi nơi khác).
Nếu dùng trên máy lạ/máy công cộng, nhớ xóa key sau khi dùng.

📚 2. Hướng dẫn sử dụng Web app

📺 Xem video hướng dẫn thao tác

Ứng dụng này giúp bạn tạo bài đọc và câu hỏi trắc nghiệm hoặc dạng khác phù hợp với các trình độ CEFR từ A1 đến C2. Bạn có thể sử dụng văn bản có sẵn hoặc nhờ AI tạo văn bản mới và sinh câu hỏi tương ứng.

✨ Bước 1: Cài đặt API

Để ứng dụng hoạt động, bạn cần cung cấp API key từ nhà cung cấp AI:

Chọn nhà cung cấp AI:
- OpenAI (GPT) hoặc
- Google (Gemini)
Dán API Key vào ô API Key.
(Key sẽ được lưu trong trình duyệt của bạn để tiện sử dụng lần sau)
Nhấn "Save Settings".

✅ Nếu đúng, trạng thái bên dưới sẽ báo "Key set. Ready."

✍️ Bước 2: Nhập văn bản để tạo câu hỏi

Cách 1: Dán văn bản

Mặc định bạn sẽ ở tab Paste Text.
Dán đoạn văn bản bạn muốn tạo câu hỏi vào.
Nhấn "Use This Text" để tiếp tục.

Cách 2: Nhờ AI tạo đoạn văn bản mới

Bấm tab Generate Text.
Nhập các thông tin:
- Word Count: số từ (từ 50–500).
- CEFR Level: trình độ.
- Topic: chủ đề (vd: Environment, Technology...).
Nhấn "Generate Text" → AI sẽ tạo đoạn văn bản phù hợp.
Nhấn "Use This Text" nếu bạn hài lòng.

🧩 Bước 3: Cấu hình câu hỏi

Sau khi chọn đoạn văn bản, bạn sẽ chuyển đến bước tạo câu hỏi:

Chọn phần văn bản để dùng:
- Whole Text: Toàn bộ đoạn văn
- Hoặc một đoạn cụ thể
Chọn dạng câu hỏi:
- MCQ: Trắc nghiệm
- Short Answer: Tự luận ngắn
- Other: Nhập định dạng riêng như True/False, Điền vào chỗ trống...
Chọn loại câu hỏi:
Có rất nhiều loại như:
- RE: Quy chiếu (đại từ)
- DE: Thông tin chi tiết (rõ ràng)
- MI: Ý chính bài
- IN: Hàm ý
- VO: Từ vựng
- (Bạn sẽ thấy phần giải thích và ví dụ khi chọn)
Nhấn "Generate Question" để tạo câu hỏi.

🧐 Bước 4: Xem và điều chỉnh câu hỏi

Sau khi tạo câu hỏi:

Bạn sẽ thấy câu hỏi, đáp án và giải thích hiển thị rõ ràng.
Nếu chưa hài lòng, bạn có thể:
- Góp ý chỉnh sửa (Feedback)
- Nhấn "Use Feedback to Revise"
- Hoặc bấm "Try Different Question" để tạo lại câu hỏi khác
✅ Hài lòng rồi? Bấm "OK & Add" để lưu câu hỏi.

📚 Bước 5: Tạo bài kiểm tra hoàn chỉnh

Sau khi bạn đã thêm ít nhất 1 câu hỏi, bạn có thể:

Nhấn "Finish Test" để tạo bài kiểm tra hoàn chỉnh.
Ứng dụng sẽ:
1. Hiển thị tiêu đề
2. Có phần hướng dẫn làm bài
3. Hiển thị đoạn văn
4. Danh sách các câu hỏi (đánh số, rõ ràng)
5. Đáp án + giải thích ở cuối bài

📋 Bước 6: Lưu và dùng bài kiểm tra

Nhấn "Copy Test" để sao chép bài kiểm tra (HTML và Text đều được hỗ trợ).
Nhấn "Create New Test" để bắt đầu lại từ đầu.

🛠️ Ghi chú kỹ thuật

Ứng dụng dùng TailwindCSS và hỗ trợ chế độ tối.
Dữ liệu API được lưu trong localStorage của trình duyệt (chúng tôi không lưu API key của bạn).
Phù hợp cho giáo viên dạy tiếng Anh, người luyện thi TOEFL/IELTS, hoặc người nghiên cứu tạo đề.

Please read the instructions below carefully before use.

Please send any feedback to the author Le Nguyen Nhu Anh (email: anhlnn@hcmue.edu.vn)

Disclaimer:

AI-generated questions may not be completely accurate or suitable for all teaching contexts – please review carefully before use.

USAGE GUIDE

🔐 1. How to Get an API Key to Use the App

To use the app, you need to enter an API key.

Don't worry! The app does not collect your API key – it is temporarily stored in your browser (localStorage) for your convenience.

You can choose from one of the following two types of API keys:

🌟 How to Get a Google Gemini API Key (Free)

👉 Watch this super quick tutorial (1 minute):
📺 https://youtu.be/kaKfUEgipEI

✅ Suitable for beginners, no payment card required.
✅ Freely usable within Google's free usage limit.

🤖 How to Get an OpenAI API Key (Paid)

👉 See the official guide here:
📄 https://help.openai.com/en/articles/4936850-where-do-i-find-my-openai-api-key

⚠️ Requires an OpenAI account linked to a payment method.
⚠️ Charges apply based on usage (tokens).

📌 Important Notes When Using Your API Key:

NEVER share your key publicly – others may use it and consume your quota.
The key is stored temporarily in your browser only (not sent anywhere else).
If using a shared or public computer, remember to delete the key after use.

📚 2. How to Use the Web App:

📺 Click to view a Tutorial Video

This app helps you generate reading passages and corresponding multiple-choice or other question types suitable for CEFR levels from A1 to C2. You can either use your own text or ask AI to create a new one along with appropriate questions.

✨ Step 1: Set Up Your API

To use the app, you need to provide an API key from an AI provider:

Choose your AI provider:
- OpenAI (GPT), or
- Google (Gemini)
Paste your API Key into the “API Key” field.
(The key will be saved in your browser for future use.)
Click “Save Settings.”

✅ If successful, the status message will say: “Key set. Ready.”

✍️ Step 2: Enter Text to Generate Questions

Option 1: Paste Your Own Text

By default, you'll be on the “Paste Text” tab.
Paste the passage you want to create questions from.
Click “Use This Text” to continue.

Option 2: Let AI Generate a New Passage

Go to the “Generate Text” tab.
Enter the following:
- Word Count (between 50–500)
- CEFR Level
- Topic (e.g., Environment, Technology...)
Click “Generate Text” → AI will create a passage.
Click “Use This Text” if you are satisfied.

🧩 Step 3: Configure Your Questions

Once you've selected a passage, you'll move to the question generation section:

Choose the part of the text to use:
- Whole Text
- Or a specific paragraph
Choose question format:
- MCQ (Multiple Choice)
- Short Answer
- Other (e.g., True/False, Fill in the Blanks...)
Select question type:
(You'll see explanations and examples when selecting these.)
- RE: Referent (pronouns)
- DE: Detail (explicit info)
- MI: Main Idea
- IN: Inference
- VO: Vocabulary
- ...
Click “Generate Question” to create your question.

🧐 Step 4: Review and Edit Questions

After generating questions, you will see:

The question
The answer choices
An explanation
If not satisfied, you can:
- Submit Feedback for Revision
- Click “Use Feedback to Revise”
- Or try a different question with “Try Different Question”
✅ Happy with it? Click “OK & Add” to save it.

📚 Step 5: Finalize the Test

Once you've added at least one question, you can:

Click “Finish Test” to generate the complete test.
The app will:
1. Show the title
2. Include test instructions
3. Display the passage
4. List all questions (numbered and clear)
5. Provide answers and explanations at the end

📋 Step 6: Save and Use the Test

Click “Copy Test” to copy the test (HTML and plain text formats supported).
Click “Create New Test” to start over.

🛠️ Technical Notes

The app uses TailwindCSS and supports dark mode.
API data is stored locally in your browser (we do not store your API key).
Ideal for English teachers, TOEFL/IELTS test prep, or assessment researchers.

Text2Quiz AI

API Settings

Step 1: Add Text

Step 2: Create Question

Question Type Details:

Questions Created So Far:

Step 3: Review Question

Feedback (Optional)

Final Test

Hướng dẫn sử dụng

Disclaimer:

HƯỚNG DẪN SỬ DỤNG

🔐 1. Cách lấy API Key để sử dụng ứng dụng

🌟 Cách lấy Google Gemini API Key (Miễn phí)

🤖 Cách lấy OpenAI API Key (Có tính phí)

📌 Lưu ý khi sử dụng API Key:

📚 2. Hướng dẫn sử dụng Web app

✨ Bước 1: Cài đặt API

✍️ Bước 2: Nhập văn bản để tạo câu hỏi

🧩 Bước 3: Cấu hình câu hỏi

🧐 Bước 4: Xem và điều chỉnh câu hỏi

📚 Bước 5: Tạo bài kiểm tra hoàn chỉnh

📋 Bước 6: Lưu và dùng bài kiểm tra

🛠️ Ghi chú kỹ thuật

How to Use This Tool

Disclaimer:

USAGE GUIDE

🔐 1. How to Get an API Key to Use the App

🌟 How to Get a Google Gemini API Key (Free)

🤖 How to Get an OpenAI API Key (Paid)

📌 Important Notes When Using Your API Key:

📚 2. How to Use the Web App:

✨ Step 1: Set Up Your API

✍️ Step 2: Enter Text to Generate Questions

🧩 Step 3: Configure Your Questions

🧐 Step 4: Review and Edit Questions

📚 Step 5: Finalize the Test

📋 Step 6: Save and Use the Test

🛠️ Technical Notes